Worklog3a³ Activity logging program for Psion Series 3a³ (c) Alfa Computing 1996³ Richard Schmidt³ Richard Sturenberghlaan 50³ 2273 GX VOORBURG³ THE NETHERLANDS (EUR)³ Email @ Internet : rschmidt@worldonline.nl³ ³ Version V1.7³ 12/26/96³ Index ===== 1. INTRODUCTION 2. INSTALLATION 2.1 REQUIREMENTS 2.2 HOW TO INSTALL 2.3 DISTRIBUTION 3. KEYBOARD REFERENCE 4. THE AUTHOR 4.1 HOW TO CONTACT THE AUTHOR 4.2 DISCLAIMER 5. HISTORY 1. Introduction =============== Welcome to WorkLog3a! WorkLog3a is a project activity logging program. It can log activities for specific projects during a work day and save time spend on these activities to a database. This program can be useful for people working on several projects having to monitor their labour and creating time-sheets. Features of WorkLog3a: - input of projects and recording activities for this projects. - calculation of: * total work hours per project within a specific period, and all projects cumulated; * total work hours per project today; * total work hours per project in a; specific week; totals are specified per day; * available and remaining budget; - export to CSV; - memo per project; - notification when exceeding workday hours and project duration; - (audible)notification when activity has expired on user specified duration forcing application to come to foreground; - printing projects and its activities/totals; - tracking remaining vacation hours - and lots of other stuff... WorkLog3a is only available in English for the Psion Series 3a. 2. Installing WorkLog3a ======================= Before using the application you should install it from your PC to your Psion. 2.1 Requirements ================ The application requires 77K RAM memory and approximately 55K ram of disk space. If your machine appears to be out of memory try to close a few applications or erase files from internal memory (after making a backup first!). 2.2 How to install ================== To install WorkLog3a: - start RCOM or MCLINK; - connect and switch on Psion link in system screen with Psion-L; - copy file WORKLOG.OPA to an \APP directory on any disk - copy file WORKLOG.HLP to an \APP\WORKLOG directory on any disk. - Create directory \WORKLOG\ on any drive for the data files. - Install the WorkLog3a application in the system screen by pressing Psion-I. Make sure you have an \OPD directory on your default drive. WorkLog3a will save its configuration to \OPD\WORKLOG.INI. 2.3 Distribution ================ The application itself consists of the following files: WORKLOG.OPA Main application WORKLOG.HLP Help screens MANUAL.TXT This manual 3. Keyboard reference ===================== File - Open - Psion-O --------------------- Opens new projects file. A projects file contains project descriptions and all the activities. A projects file consists of three files and optionally some memo files: \WORKLOG\EXAMPLE.WKL projects \WORKLOG\EXAMPLE.WKT activities \WORKLOG\EXAMPLE.WKI project info \WORKLOG\EXAMPLE\*.WKM memos for EXAMPLE File - New - Psion-N --------------------- Create new projects file. New files will be stored in the \WORKLOG\ directory. File - Tidy up - Psion-K ------------------------ This option can be used to tidy up the activities file. All activities for all or marked projects will be removed before or after a specific date. File - Export - Shift-Psion-Q ----------------------------- Export all or marked projects to a CSV text file. FILE - CSV text file TYPE - All field in the current WorkLog database will be exported to a text file. It's possible to include project information for each activity as well. PROJECTS - Select between exporting activities for all or only marked projects. SEPARATOR - Select between four types of field separators. Record separator will always be a carriage return and line feed. Search - Find - Psion-F or F ---------------------------- Find project in list. Searches through projects and makes an occurrence current project. Search - Find next - Psion-G or G --------------------------------- Find next project in list. Searches from current project to end. Search - Jump - Psion-J ----------------------- Jumps to project by number. Every project in the list is preceded by its record number. Use jump to jump to a project by entering this record number. Search - Jump - Esc ------------------- Bring up speed list, jump to project Project - Enter - Psion-E ------------------------- Add a new project to the project file. A maximum of 999 projects can be entered. PROJECT - short description for project DESCRIPTION - long description for project CHARGE/HOUR - internal charge per hour, this information is used to determine the remaining budget. BUDGET - budget (money value) for this project Project - Enter - Psion-U or ENTER ---------------------------------- Update current project. Updated project are always moved to the end of the list. Project - Delete - Psion-D or DELETE ------------------------------------ Delete current or marked projects. Project - Details - Shift-Psion-E --------------------------------- Edit details for current project. These detail are just extra project information. The duration field is used to check if activities exceed this duration. Project - Info - Psion-I ------------------------ Display information about: 1. number of projects in current project file 2. number of activities for ALL projects 3. number of activities for CURRENT project Project - Mark current - Psion-M -------------------------------- Mark current project. Marked projects can be deleted, exported or printed in one pass. All reports on screen or printer apply to either ALL projects or MARKED projects. Project - Mark all - Psion-A ---------------------------- Mark all projects. Project - Unmark all - Shift-Psion-U ------------------------------------ Unmark all projects Memo - Edit - Psion-+ --------------------- Create or edit memo for current project. Each project can have one memo. This option launches the built in WORD application. Therefore memos are limited to 40000 characters. Memos are stored in a subdirectory (with same name as projects file) in the directory that contains the project files (usually \WORKLOG\). The names for the memo files are equal to the internal project id number (invisible for user). Be aware when renaming a projects file to rename also the memos subdirectory. If a project has a memo a '²' character will be shown next to the project number. Memo - Delete - Shift-Psion-K ----------------------------- Delete memo file for current project. The '²' character will disappear. Activity - Start - Psion-S, S or SPACE -------------------------------------- Start activity for current project. Depending on your settings, a dialog box appears (at the end or start of an activity) querying the description for the activity. In time stamp mode this key combination can also be used to start or stop an activity RECORD MODE During the activity a dialog box is displayed showing the elapsed time and remaining duration time. The duration of an activity acts as a countdown timer for activities. TIME STAMP MODE During the activity almost all program functionality is available. Except for functions that modify the activities database. Depending on your settings, an activity can be stopped automatically forcing WorkLog3a to come to foreground and beep optionally. WorkLog3a allows for a maximum of 3000 activities per projects file. Activity - Manual entry - Shift-Psion-M --------------------------------------- Add activity to activity database manually without having to start (record) an activity. This option can be used when you "forgot" to start a new activity and want to add it afterwards. It is possible to enter: - a period with start and end date; - a duration with start date and a duration of 15min, 30min, 1hr, 2hrs, 4hrs or 8hrs. Activity - View - Psion-V or TAB or Shift-TAB --------------------------------------------- List all activities for current project. This dialog shows categories, descriptions, start/end date and duration for all activities. Shift-TAB shows all activites for all projects Psion-U or Enter Update activity Psion-D or Delete Delete activity Psion-S Sort activities Psion-F Find activity Psion-G Find next activity Psion-P Move current activity to other project. Select project from list to move activity to Esc Close activity list Help Help Menu Menu Activity - Categories - Psion-C ------------------------------- Every activity has a description. Categories can be used to categorize or group activities. A maximum of 10 categories can be entered. Activity - Vacation - Psion-V ----------------------------- Update remaining vacation hours for this year. It is possible to add or substract hours. remaininghours=remaininghours+add-subtract Totals - None - Psion-- ----------------------- Stop display of totals in project table view. Switching off totals speeds up scroling. Totals - Period - Shift-Psion-P ------------------------------- Calculates total labour per project in a specific period. If projects are marked than only marked project will be calculated. Totals - Day - Shift-Psion-D ---------------------------- Calculates total labour per day for a maximum of 7 consecutive days starting at a specific date. Totals - Week - Psion-W ----------------------- Calculates total labour per day in a week. The number of working days (1-7) in a week depends on your settings in the preferences dialog (default 5). Totals - Today - Psion-* or * ----------------------------- Calculates total labour today. Totals - Remaining budget - Psion-B ----------------------------------- Calculates remaining budget per project. Uses budget and charge/hour specified with project. Totals - Set filter - Shift-Psion-F ----------------------------------- Normally the calculation of totals applies to all activities. By setting a filter, only activities with same cagegory description as filter will be taken in account when calculating totals. Special - About - Shift-Psion-A ------------------------------- Displays about information. Special - Set preferences - Psion-Q ----------------------------------- Set global preferences. These preferences are devided over three pages. TIME FORMAT - time format for displaying, exporting and printing time. WORK HOURS PER DAY - length of workday in hours. Used in time calculations. START OF WORK DAY - start time of work day used for default time in manual entries. WORK DAYS PER WEEK - number of work days per week. This field determines the number of work days shown in a week report. DEFAULT CHARGE FOR NEW PROJECTS - default charge per hour used when entering new projects. DEFAULT BUDGET FOR NEW PROJECTS - default budget used when entering new projects. MODE activities can be logged in record or time stamp mode. In record mode a modal dialog will be shown with activity progress information. The application is suspended until the pending activity is stopped. In stamp mode almost all functionality is available between starting and stopping an activity. In this mode the progress dialog is not shown. PROMPT FOR DESCRIPTION - prompt for activity description when starting or stopping a task. Three types of prompt are available: - Do not ask; - Before starting; - When stopping. CONFIRM STOP ACTIVITY - Requires confirmation for stopping activities in case of accidently pressing the space bar. WORKHOURS NOTIFICTION - totals for today are calculated when an activity is stopped. DEFAULT TIME ENTRY - option for setting default time when entering manual activities. Selectable system time or start of work day time. TIME UNIT - default time unit for new activities. Some lawyer use time units of 6 minutes. Set to 00:00:00 if you do not want to use time units. DEFAULT ACTIVITY DURATION (only record mode) Default activity duration for new activities. Depending on setting the activity will continue or terminate after this time has elapsed. It's also possible to select an audible warning. ON EXPIRATION DURATION (only record mode) Determines what action to take when activity duration has elapsed (see setting above). DISPLAY GRID LINES Display of horizontal grid lines for better reading. SURPRES ZERO VALUES Display of zero time/money values. DISPLAY DESCRIPTION Display of description or category in activity view. DISPLAY TIME Display/edit of end date/time or duration in activity view. PERFORM OVERFLOW CHECK Check for each project if total activity time exceeds project duration when calculating totals. Projects exceeding their duration will show a up arrow next to the project number. Otherwise a down arrow will be displayed in the project list. Settings are saved to \OPD\WORKLOG.INI Special - Zoom in - Psion-Z --------------------------- Enlarge screen font used for displaying projects. Special - Zoom out - Shift-Psion-Z ---------------------------------- Reduce screen font used for displaying projects. Special - Print setup - Psion-Y ------------------------------- Select between printing to file or parallel port. LINES/PAGE - maximum lines per page for work hours reports. HEADER - text header to appear on top of each page. Special - Print - Psion-P ------------------------- Print totals for period, week or subsequent days. Set "Include activities" to yes if all activities are to be printed as well. Special - Exit - Psion-X ------------------------ Exit application. 4. The author ============= 4.1 How to contact the author ============================= The author can be reached by mailing to: Alfa Computing Richard Schmidt Richard Sturenberghlaan 50 2273 GX VOORBURG THE NETHERLANDS (EUR) Email @ Compuserve : 100735,331 <> Email @ Internet : rschmidt@worldonline.nl Homepage : http://www.worldonline.nl/~rschmidt/ (check out this home page for the latest versions) 4.2 Disclaimer ============== The author takes no responsibility for any lost data or hardware malfunctions of any kind due to the use of this software or any other software that ships with WorkLog3a. 5. History ========== 09/03/96 Version 1.0 test * Initial test release. 26/03/96 Version 1.0.1 * Bug fixes - insufficient memory message for reports; - bug in calculating total cost per period; - bug in auto terminating tasks and coming to foreground. * Tracking remaining vacation hours * Enter task manually: period or hours * Configurable number of work days a week (1..7) * Faster calculation of totals * Activity filter option in totals dialog * Maximum of 3000 activities per database (was 1000) * Indication of attached memo to project * Memo files are also deleted when deleting projects * Find also searches in description field * Default category for new activities 12/04/96 Version 1.1.0 * Table view for activities - delete activity - update activity - find(next) activity - move activity to other project - sort activities on description, date/time * Speed list for jumping to projects ESCAPE in project view brings up a list of projects * Optionally search from top or current position * Default system time for manual entry - system time - start of workday * Tidy up before or after specific date * Tidy up only marked projects * Confirmation when stopping activity * Suppres zero values 29/04/96 Version 1.1.3, 1.1.4 * Time stamp recording mode * Form feed at end of print job * Two fontsizes in project view caused overlap in activity view * Project name in record dialog * More relexaed activity filter * Default is curent week in totals for week dialog * Days were calculated in 24hrs now it depends on the number of hours per workday * Bug fix font activity list * Bug fix stamp mode 08/12/96 Version V1.5 * ESC in preferences dialog cancels subsequent dialogs * "include activities" option in print dialog moved to top of dialog * NEW display formats : dddd:hh:mm, dddd:hh and hh:mm * Notification when exceeding project duration with up and down arrows next to project number * Separate field for catagory in activities database. In previous versions activity description and category shared the same field * When printing activities, category an activity duration are also printed * Cosmetic changes and correction of typos * Displaying of totals: totals workdays spend per project * Configurable time-unit per activity * Removed confusing workday alternative of 24hrs * Option to delete project memos * Project details added: - project start date - project end date - fixed cost - expenses - address and telephone number * Updating activities: now allows for displaying, sorting and entering of start time and duration * Improved font zoom * CSV ascii export 09/12/96 Version V1.5.1 * bug fix, div by zero in case of workhours per day 00:00 15/11/96 Version V1.5.2/3 * bug fix, stack error in preferences dialog * bug fix, activity update error 12/26/96 Version V1.7 * converted to FREEWARE